home *** CD-ROM | disk | FTP | other *** search
/ EuroCD 3 / EuroCD 3.iso / Communication / Citadel_BBS / Util / Citadel_aff.lha / aff.doc next >
Encoding:
Text File  |  1997-07-28  |  2.8 KB  |  61 lines
  1. Aff
  2.  
  3.    Aff, which stands for Automatic File Forwarding, is a Citadel-86
  4. utility designed to simplify the job of automatically forwarding
  5. files from one system to another with only some initial sysop
  6. assistance.
  7.  
  8.    The basic idea is there are certain files, updated from time to time,
  9. which should be sent to some set of systems after each update.
  10. (If this doesn't seem likely to you, then you probably have little
  11. use for this utility.)  By using the Aff utility in combination
  12. with the Citadel #event to bring your system down periodically
  13. to run Aff, you can automate the process of sending said files to
  14. other systems when they are updated.
  15.  
  16.    Enough of the arm-waving.  In order for this to work, you have to
  17. tell Aff what you want sent, and where.  You do this via a file you
  18. construct named CTDLAFF.SYS, which will be located in your #NETAREA
  19. directory.  The structure of this file is:
  20.  
  21.      <filename>
  22.      <system name> : 0
  23.         ...
  24.      <system name> : 0
  25.      <blank line>
  26.      <filename>
  27.      <system name> : 0
  28.         ...
  29.      <system name> : 0
  30.      <blank line>
  31.  
  32.    The first line is the name of the file which will need to be sent
  33. each time it's updated.  There is one trick to this "filename" -- while
  34. you create the file in #NETAREA, you run the Aff utility from the same
  35. place you run Ctdl, and therefore Aff will look at the filename from
  36. the perspective of the normal Citadel directory, not #NETAREA.  So, if
  37. you use "relative" file names (like "/door/hello.zip", etc), you'll have
  38. to be careful.  If you want to be smart, just use absolute file paths
  39. (like "DH0:PRODUCT/STUFF.LHA").
  40.  
  41.    All of the following lines up to the first blank line are the names
  42. of systems the file should be sent to.  Notice the format -- it's
  43. "<system name> : 0".  The reason for the ": 0" is that Citadel-86 will
  44. actually use CtdlAff.Sys to remember the last time it sent the file on
  45. to each system.  As the days pass, the "0" you should write in there
  46. will change to other numbers.  They represent the date stamp of the
  47. file last time you checked and sent it.  Don't mess with those numbers
  48. unless you know what you're doing (it's usually not necessary, anyways).
  49.  
  50.    You can update CtdlAff.Sys anytime you like, deleting systems,
  51. adding systems, adding whole new file forwarding specs.  However, the
  52. Aff utility itself cannot be run from within Citadel; the system must
  53. be down.  For that reason, and if you don't already, you may
  54. want to consider putting together a #event of type external which will
  55. cause Aff to be run on an appropriate basis.  See INSTALL3.MAN for more
  56. information.
  57.  
  58.    If you make a copy of the CTDLTABL.SYS file before you run CTDL, you
  59. can run AFF using that copy of the CTDLTABL.SYS file.  This seems to work
  60. with no problems.  It could however be a problem if you change your node
  61. lists so this is not the normal recommended method of running AFF.